home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / race160e.zip / RACEREAD.ME < prev   
Text File  |  1992-04-26  |  12KB  |  275 lines
  1.  
  2.  
  3.    ┌────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┐
  4.    │                                                                      │
  5.    │    THIS IS A BETA VERSION!  This BETA version of RACE has been       │
  6.    │    released to the general public under the following conditions:    │
  7.    W                                                                      W
  8.    A      1: You accept FULL responsibility for any and all damage        A
  9.    R         this software may cause to your system because of bugs       R
  10.    N         or any other unforseen problems.                             N
  11.    I                                                                      I
  12.    N      2: You should not expect bug fixes or updates with any          N
  13.    G         regularity nor should you expect elaborate docs or           G
  14.    │         packaging.                                                   │
  15.    │                                                                      │
  16.    │                                                                      │
  17.    │                                                                      │
  18.    └────── WARNING ──────────────── WARNING ─────────────── WARNING ──────┘
  19.  
  20.  
  21. DO NOT use this software if any of the above bothers you. At this point in
  22. time, RACE v1.60 is largely untested.  It seems to work ok for me, and I
  23. made every effort to insure the quality, but stuff happens.
  24.  
  25.  
  26. RACE v1.60e - 4/26/92
  27.  
  28. fixes
  29. -----
  30.  
  31. If you used ALT-D to delete a set of answers for a user that RACE
  32. reported "this user doesn't exist", RACE would duplicate record number 0
  33. (the Sysop's record) over record number 1.  All ALT keys, templates and
  34. anything else that modifies a user record is now correctly disabled if a
  35. non-existant user's answers are on screen. <V>IP, <T>rash, <M>ark and
  36. <P>ick are usable.
  37.  
  38. Using <V>alidate then left-arrow (as opposed to Ctrl-V validation) would
  39. sometimes cause a lock-up or display of a set of answers consisting of
  40. nothing but trash.
  41.  
  42. RACE would, under certain conditions, generate an error when entering
  43. validation.  The RACE.ERR file would indicate that there were too many
  44. files open.
  45.  
  46.  
  47. RACE v1.60d -
  48.  
  49. Somehow (couldn't possibly have been my fault! :-)) the old message posting
  50. code got into the new validation routines and support of the ^F codes for
  51. imported messages was lost.  FIXED.
  52.  
  53. Fixed a bug that caused RACE to error out under certain conditions when
  54. running an external pack from the RACE <U>tils menu.
  55.  
  56. Use of <V>alidation without an answer file was disabled in the previous
  57. version.  Fixed.
  58.  
  59. Added <M>ark to validation.  This will allow you to toggle a set of
  60. user answers DELETED in the index.  This will not affect the status
  61. of the user, only the answers.  The answers will only be removed after
  62. running eRACEm v0.7 with the -A switch.  Note that ALT-D toggles the
  63. answers in addition to toggling the user's deleted status so it is only
  64. necessary to use <M>ark if you want to delete a set of answers without
  65. deleting the user or vice versa.
  66.  
  67. "DELETED" appears at the top of the answer text window when a set of
  68. answers is marked deleted.  This DELETED indicator only refers
  69. to the current answer set and in no way reflects the state of the
  70. user record DELETED flag.
  71.  
  72. See the eRACEm v0.7 ERACEM.NEW file for info on packing the answer file.
  73.  
  74. RACE v1.60c - 03/22/92
  75.  
  76. WHOOPS!
  77. ------
  78. The Whoops! function has been changed to support eRACEm 0.6's writing
  79. of the users extra info (subdate, birthdate, etc.) to a USERSXI.OLD file.
  80. If you use the Whoops! function in RACE v1.60c, full support will only be
  81. achieved by using eRACEm 0.6 or above.  By saving ALL the user info,
  82. restoring a user with Whoops! will be a bit more useful.
  83.  
  84. Validation BUG FIX
  85. ------------------
  86. User subscription dates were not properly updated (again) when using a
  87. template to upgrade a user.  Fixed.
  88.  
  89. VALIDATION
  90. ----------
  91. Validation routines are in the process of being changed. If you use
  92. validation regularly as many RACE users do, I suggest you keep the current
  93. release copy of RACE until you are sure this version is working to your
  94. satisfaction.  This =IS= a beta copy!
  95.  
  96. There have been some major changes to Validation.  RACE now creates and
  97. constantly updates an index file for the answer file.  This file will have
  98. the same filename as the answer file and an extension of .IDX and it will
  99. be created in the RA system directory.  There will be one .IDX file for
  100. each answer file you view with validation.  Each record in the .IDX file
  101. (one for each set of answers) consumes 9 bytes of disk space.
  102.  
  103. Creation and updating of the index is done automatically.  RACE parses the
  104. answer file and updates the index each time you go into validation or when
  105. you <P>ick a new answer file from within validation.
  106.  
  107. RACE also does a simple test of the index before parsing.  RACE reads the
  108. last index record and attempts to go to that position in the answer file.
  109. If that position does not exist (such as when you deleted the answer file
  110. but not the index) then RACE will rebuild the index from the start.
  111.  
  112. The above test will not account for all possible problems.  If, for
  113. example, you manually edit answers out of the file then allow RA to add new
  114. answers before ever running RACE, the test may past but the last old
  115. entries in the index may not actually point to the start of a set of
  116. answers.  If in doubt, delete the .IDX file and allow RACE to rebuild it.
  117. It only takes a few seconds on average sized answer files.
  118.  
  119. This index file contains a 'last read' pointer so that RACE knows where
  120. you left off on validating during your last use of CTRL-V type validation.
  121.  
  122. This is the first record in the index.  The remaining records contain a 32
  123. bit CRC of the user name (for searching), a long integer that contains the
  124. exact byte offset of the user's answers in the answer file and an attribute
  125. byte that allow flagging a set of answers deleted when you delete the user.
  126. RACE currently sets this deleted flag but at this point in time there is no
  127. packing util to get rid of the deleted answers nor does RACE handle those
  128. records in any special way.  I do plan to create a packing util for the
  129. answer file.
  130.  
  131. You may now allow your answer file to constantly grow and not have to
  132. put up with RACE starting at the beginning each time you go into
  133. validation.  Keep in mind that the 'last read' is wherever you were when
  134. you quit last time not the highest record number you viewed.  If you jump
  135. to the first record then quit, RACE will start at the first record on your
  136. next entry to validation.
  137.  
  138. You now move forward AND backward through the answer file using the right
  139. and left arrow keys.  You may also use HOME and END to jump to the first
  140. and last set of answers respectively.  RACE no longer uses <N>ext.
  141.  
  142. FIND
  143. ----
  144. F)ind will still allow you to find other answers the currently viewed
  145. user may have but you will now be prompted "Search Forward?". <Y> or
  146. <ENTER> to this prompt will search forward otherwise hit <N> to search
  147. backwards.  Once the search has begun AND answers are found, you may move
  148. back and forth to the various answer sets of that user by using the arrow
  149. keys.  Once you are at the last set of answers for that user (in either
  150. direction), RACE reports no more answers found and the find command is
  151. toggled off.
  152.  
  153. SEARCH
  154. ------
  155. S)earch will allow you to search for a specific user's answers.  Since
  156. RACE searches the index file for a CRC match and not the answer file, it
  157. will only find EXACT matches.  Your input is converted to uppercase and
  158. then a CRC is calculated on the name.  RACE then searches the index for a
  159. match. Because of this method, partial names will never score a match since
  160. the CRC will never be exactly the same.
  161.  
  162. VIP & TRASH
  163. -----------
  164. V)ip and T)rash have been added.  These will insert the currently
  165. viewed user name into the VIP.CTL or TRASHCAN.CTL file as the command
  166. letter indicates.  Removing the user names from those files is still
  167. done by the old manual method.
  168.  
  169.  
  170. ANSWER FILE
  171. -----------
  172. If you do not care to keep your answer file around, remove the index file
  173. when you remove the answer file.  In other words, if you remove the
  174. NEWUSER.ASW, also remove the NEWUSER.IDX file.  As mentioned above, RACE
  175. attempts to handle invalid indexes but it is possible to confuse it.
  176.  
  177. The "Storage file" is no longer supported in RACE. Because of the indexing
  178. method and RACE's ability to start where you left off, it was felt that
  179. this was redundant.  The actual answer file may now be used as storage.
  180. This makes it easy to review a particular user's answers at any time while
  181. in RACE.
  182.  
  183.  
  184. INDEX STRUCTURE
  185. ---------------
  186. For those that may have some use for the answer file index that RACE
  187. creates, or if you are just curious, here's the structure.
  188.  
  189.  AnswerIdx = Record
  190.                Position  : Longint;   {byte position of start of answer text}
  191.                NameCRC   : Longint;   {32 bit CRC of uppercase name}
  192.                Attribute : Byte;      {bit 0 set = deleted}
  193.              End;
  194.  
  195. Record 0 in the index file contains (in AnswerIdx.Position) the index
  196. record number of the last answers viewed when you quit validation.
  197.  
  198. A name CRC was used in place of the actual string for space savings.  While
  199. the full name would have made searching for partial matches possible, I
  200. felt that the extra space required for the index on large answer files
  201. would have been detrimental.
  202.  
  203. RACE uses the answer start position to find the desired answers AND then
  204. looks at the next index record to get the start of the next set for the
  205. purpose of determining where the desired answers END.  So you can see that
  206. manually editing the answer file could confuse matters if you don't force
  207. RACE to re-index.
  208.  
  209.  
  210. RACE v1.60b - 02/14/92
  211.  
  212. Corrected a bug in the REPORTS portion of the code.  Going into reports
  213. and then answering 'N' to "Continue with report" would generate an error.
  214.  
  215.  
  216.  
  217.  
  218. RACE v1.60a - 01/24/92
  219.  
  220. Totally rewrote the message posting routines and improved the handling of
  221. the imported text.  RACE also now supports most, but not all, of the ^F
  222. text control codes that RemoteAccess provides.  The ^F codes are the
  223. individual user information codes. The codes may be used in any text that
  224. RACE places in the RA message base.  This includes manually typed messages
  225. using RACEEDIT or welcome messages in validation.
  226.  
  227. All valid text control codes are listed at the end of this document.
  228.  
  229. Fixed <A>dding of months in validation.  previously, if one selected <A>dd
  230. (as opposed to <R>estart) the date would have the correct number of months
  231. added but the day of the month was usually wrong.
  232.  
  233.  
  234. Added option for user name format in lists.  You may choose whether or not
  235. you want names to appear as "Lastname, Firstname" or "Firstname Lastname".
  236. This is active in REPORTS, and the 'usered' style user list screen.  Go
  237. into RACECFG => Miscellaneous to toggle this option to your desired setting.
  238.  
  239.  
  240. Packing and sorting have been removed from RACE.  This is now handled by the
  241. external 'eRACEm' utility provided with RACE.  See the eRACEm docs that
  242. accompany that file.  <W>hoops! for restoring users packed out by eRACEm
  243. is still available.  This option has replaced <K>eys in the main menu.
  244.  
  245.  
  246. The following control codes are active:
  247.  
  248. ^FA = user's full name
  249. ^FB = user's location
  250. ^F3 = user's handle
  251. ^F4 = Date of first call
  252. ^F5 = date of birth
  253. ^F6 = Subscription date
  254. ^FC = Password
  255. ^FD = Data phone number
  256. ^FE = Home phone number
  257. ^FF = Date of last call
  258. ^FG = Time of last call
  259. ^FL = NetMail credit
  260. ^FM = Total messages posted
  261. ^FO = Security level
  262. ^FP = Total calls to the BBS
  263. ^FQ = Number of uploads
  264. ^FR = Kilobytes of uploads
  265. ^FS = Number of downloads
  266. ^FT = Kilobytes of downloads
  267. ^FU = Minutes used today
  268. ^FW = user's first name
  269. ^F? = User's file ratio in number of files.
  270. ^F@ = User's file ratio in Kilobytes
  271.  
  272. If you are not familiar with how these codes work, see the RemoteAccess
  273. documentation.  RACE handles the codes in exactly the same manner.
  274.  
  275.